/*=========================================================================

  Program:   ORFEO Toolbox
  Language:  C++
  Date:      $Date$
  Version:   $Revision$


  Copyright (c) Centre National d'Etudes Spatiales. All rights reserved.
  See OTBCopyright.txt for details.


     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notices for more information.

=========================================================================*/


// Software Guide : BeginLatex
//
// This example shows how to use the \doxygen{itk}{ImageLinearIteratorWithIndex} for
// computing the mean across time of a 4D image where the first three
// dimensions correspond to spatial coordinates and the fourth dimension
// corresponds to time. The result of the mean across time is to be stored in a
// 3D image.
//
// \index{Iterators!and 4D images}
// \index{ImageLinearIteratorWithIndex!4D images}
//
// Software Guide : EndLatex

#include "otbImage.h"
// Software Guide : BeginCodeSnippet
#include "itkImageLinearConstIteratorWithIndex.h"
// Software Guide : EndCodeSnippet
#include "otbImageFileReader.h"
#include "otbImageFileWriter.h"

int main(int argc, char *argv[])
{
  // Verify the number of parameters on the command line.
  if (argc < 3)
    {
    std::cerr << "Missing parameters. " << std::endl;
    std::cerr << "Usage: " << std::endl;
    std::cerr << argv[0]
              << " input4DImageFile output3DImageFile"
              << std::endl;
    return EXIT_FAILURE;
    }

// Software Guide : BeginLatex
//
// First we declare the types of the images
//
// Software Guide : EndLatex

// Software Guide : BeginCodeSnippet
  typedef unsigned char            PixelType;
  typedef otb::Image<PixelType, 3> Image3DType;
  typedef otb::Image<PixelType, 4> Image4DType;

  typedef otb::ImageFileReader<Image4DType> Reader4DType;
  typedef otb::ImageFileWriter<Image3DType> Writer3DType;

  Reader4DType::Pointer reader4D = Reader4DType::New();
  reader4D->SetFileName(argv[1]);

  try
    {
    reader4D->Update();
    }
  catch (itk::ExceptionObject& excp)
    {
    std::cerr << "Error writing the image" << std::endl;
    std::cerr << excp << std::endl;
    return EXIT_FAILURE;
    }

  Image4DType::ConstPointer image4D = reader4D->GetOutput();

  Image3DType::Pointer image3D = Image3DType::New();
  typedef Image3DType::IndexType   Index3DType;
  typedef Image3DType::SizeType    Size3DType;
  typedef Image3DType::RegionType  Region3DType;
  typedef Image3DType::SpacingType Spacing3DType;
  typedef Image3DType::PointType   Origin3DType;

  typedef Image4DType::IndexType   Index4DType;
  typedef Image4DType::SizeType    Size4DType;
  typedef Image4DType::SpacingType Spacing4DType;
  typedef Image4DType::PointType   Origin4DType;

  Index3DType   index3D;
  Size3DType    size3D;
  Spacing3DType spacing3D;
  Origin3DType  origin3D;

  Image4DType::RegionType region4D = image4D->GetBufferedRegion();

  Index4DType   index4D   = region4D.GetIndex();
  Size4DType    size4D    = region4D.GetSize();
  Spacing4DType spacing4D = image4D->GetSpacing();
  Origin4DType  origin4D  = image4D->GetOrigin();

  for (unsigned int i = 0; i < 3; ++i)
    {
    size3D[i]    = size4D[i];
    index3D[i]   = index4D[i];
    spacing3D[i] = spacing4D[i];
    origin3D[i]  = origin4D[i];
    }

  image3D->SetSpacing(spacing3D);
  image3D->SetOrigin(origin3D);

  Region3DType region3D;
  region3D.SetIndex(index3D);
  region3D.SetSize(size3D);

  image3D->SetRegions(region3D);
  image3D->Allocate();

  typedef itk::NumericTraits<PixelType>::AccumulateType SumType;
  typedef itk::NumericTraits<SumType>::RealType         MeanType;

  const unsigned int timeLength = region4D.GetSize()[3];

  typedef itk::ImageLinearConstIteratorWithIndex<
      Image4DType> IteratorType;

  IteratorType it(image4D, region4D);
  it.SetDirection(3);   // Walk along time dimension
  it.GoToBegin();
  while (!it.IsAtEnd())
    {
    SumType sum = itk::NumericTraits<SumType>::Zero;
    it.GoToBeginOfLine();
    index4D = it.GetIndex();
    while (!it.IsAtEndOfLine())
      {
      sum += it.Get();
      ++it;
      }
    MeanType mean = static_cast<MeanType>(sum) /
                    static_cast<MeanType>(timeLength);

    index3D[0] = index4D[0];
    index3D[1] = index4D[1];
    index3D[2] = index4D[2];

    image3D->SetPixel(index3D, static_cast<PixelType>(mean));
    it.NextLine();
    }
// Software Guide : EndCodeSnippet

// Software Guide : BeginLatex
//
// As you can see, we avoid to use a 3D iterator to walk
// over the mean image. The reason is that there is no
// guarantee that the 3D iterator will walk in the same
// order as the 4D. Iterators just adhere to their contract
// of visiting all the pixel, but do not enforce any particular
// order for the visits.  The linear iterator guarantees to
// visit the pixels along a line of the image in the order
// in which they are placed in the line, but do not states
// in what order one line will be visited with respect to
// other lines.  Here we simply take advantage of knowing
// the first three components of the 4D iterator index,
// and use them to place the resulting mean value in the
// output 3D image.
//
// Software Guide : EndLatex

  Writer3DType::Pointer writer3D = Writer3DType::New();
  writer3D->SetFileName(argv[2]);
  writer3D->SetInput(image3D);

  try
    {
    writer3D->Update();
    }
  catch (itk::ExceptionObject& excp)
    {
    std::cerr << "Error writing the image" << std::endl;
    std::cerr << excp << std::endl;
    return EXIT_FAILURE;
    }

  return EXIT_SUCCESS;
}
